home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / cheetah3.lzh / CHEETAH.V30 < prev   
Encoding:
Text File  |  1990-09-28  |  10.0 KB  |  220 lines
  1.  
  2.  
  3.  
  4.  
  5.                          Documentation for Cheetah
  6.  
  7.                          (C) 1989,90  by Jay Jones
  8.  
  9.  
  10.  
  11.  
  12. Every effort has been made to ensure that this program is safe to use and
  13. error free.... HOWEVER, I accept no responsibility for any damage or data
  14. loss that may occur from the use of this program.
  15.  
  16.  
  17.  
  18.  
  19.  
  20.   This program is being distributed as Shareware. This means that you may
  21.  
  22. give this program out to your friends or post it on Bulletin Boards freely
  23.  
  24. as long as the program and this text file are kept together and remain 
  25. unchanged. These files may not be distributed commercially without my 
  26. written consent. All I ask is that if you like this program and use it, 
  27. please send a donation ($20 Suggested?) to the address listed at the end 
  28. of this file. The only way that I can continue to develop and support this 
  29. program is if I receive some compensation for the MONTHS I have devoted to 
  30. its development. Your registration also insures that you will be informed 
  31. of any upgrades made available. Enough said.
  32.  
  33.  
  34.  
  35.   Cheetah is designed as a high speed file copying utility. Hard Drive
  36.  
  37. users will find it the most useful, however it does fully support floppy
  38.  
  39. drives also. Effective transfer rates vary depending on the hardware and
  40.  
  41. the data being copied. Hard drive users can expect to see transfer rates
  42.  
  43. ranging from 6 to 14+ Mb/Min.
  44.  
  45.  
  46.  
  47. Selecting Paths:  There are two ways to select your source/destination
  48.  
  49. paths. One is to highlight the drive letter and click in the "Select Path"
  50.  
  51. boxes, the other is to double click the drive letter. When double 
  52. clicking, first the source then the destination will be selected. After 
  53. that, you can use normal double clicks to select source or hold down the 
  54. right button when double clicking to change destination. To go into a 
  55. folder, either double click it or highlight it and click in the "Select 
  56. Path" box.
  57.  
  58.  
  59.  
  60. Selecting Files:  Once both source and destination paths are selected, 
  61. files can be selected by clicking on them, or by holding down and 
  62. dragging. "Select all" will toggle all files on/off. Also see "Auto 
  63. Select" in the "Extras" menu below.
  64.  
  65.  
  66.  
  67. Extras Menu:  From this menu you can see buffer and mem free sizes, change
  68.  
  69. the file sort order, choose whether or not to display the performance 
  70. window after the copy, or go to either of the 3 submenus (Auto Select, 
  71. Free Space or Zero Drive).
  72.  
  73.  
  74.  
  75. Auto Select Menu:  This routine will go through the source path top to
  76.  
  77. bottom (as displayed) and select as many files as can fit into the
  78.  
  79. destination free space. All previously selected files are ignored. The
  80.  
  81. other items are for setting filtering of which files to select. The "File
  82.  
  83. Mask" and the two date fields are ignored if left blank.
  84.  
  85.  
  86.  
  87. Archive bit Sensitivity (In the Auto Select Menu):  To enable archive bit
  88.  
  89. sensitivity, highlight the "Archive bit sensitive" box. If this box is
  90.  
  91. selected, the select routine will take into account archive bit status
  92.  
  93. relative to the "Select when" option. If archive bit sensitivity is
  94.  
  95. enabled, the directories in the main menu will display archive bit status
  96.  
  97. by showing a ":" if the bit is on, and a "." if it is off. Any time the
  98.  
  99. archive bit sensitivity is enabled and a copy is performed, the bit status
  100.  
  101. of the copied files is changed in memory (ie: "Select when" set ON, all
  102.  
  103. copied files are set to OFF). If "Write Src Dir" is ON, the modified 
  104. source directory archive bit status will be saved to disk, otherwise it is 
  105. changed IN MEMORY ONLY and is lost when source paths are changed or you 
  106. exit the program.
  107.  
  108.  
  109.  
  110. Quick Keys:  From the main menu, there are several "Hot Keys" to get the
  111.  
  112. sub-functions quickly.
  113.  
  114.         ^A      Auto Select Menu
  115.  
  116.         ^F      Free Space
  117.  
  118.         ^Z      Zero Drive
  119.  
  120.         ^B      Toggle Folder Buffering On/Off
  121.  
  122.  
  123.  
  124.  
  125.  
  126. Aborting:  Copies can be aborted by pressing the UNDO key, the program 
  127. will then prompt you to verify the abort. This can be done during all but 
  128. the final stage of the copy.
  129.  
  130.  
  131.  
  132. Folder Buffering: If folder buffering is enabled the program will try to
  133.  
  134. load all copied folders into the main buffer. If you are having problems
  135.  
  136. with buffer size or errors try turning the buffering off to save memory.
  137.  
  138. DO NOT exceed 200 folders in a single copy with buffering on!
  139.  
  140.  
  141.  
  142. Note: If you are using a version of TOS less than 1.4 you may notice that 
  143. the double click is a bit slow. This is due to slow return times from the 
  144. AES. It may be easier with old TOS to make selections by using the path 
  145. select boxes at the tops of the file windows.
  146.  
  147.  
  148.  
  149.  
  150.  
  151. ***********************        Warning        *********************** 
  152.   Cheetah does not use standard calls to its copying/deleting! This can 
  153. cause problems when you exit the program with GEM not being updated 
  154. properly as to the changes that have been made. Normally this is only a 
  155. problem if you are running some sort of caching program, and  can usually 
  156. be resolved by hitting ESC on the affected drives at the desktop. If you 
  157. are unsure as to whether GEM has been updated properly, play it safe, 
  158. REBOOT!
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. **********************************************************************
  171.  
  172. *                   Changes for ver 1.1 11/15/89                     * 
  173. **********************************************************************
  174.  
  175.  
  176.  
  177. Caching:
  178.  
  179.   Routines have been added when exiting Cheetah to force GEM to re-read 
  180. the disks even when caching programs are resident! These routines have 
  181. been tested with CACHExxx.PRG, HDACCEL.PRG, and ICD's v4.x.x booter, and 
  182. all seem to work fine. The ONLY thing that we have found that can still 
  183. cause a problem is if you have a window open into a folder, then delete 
  184. that folder from within Cheetah. If you have any problems, please let me 
  185. know.
  186.  
  187.  
  188.  
  189. File Size,Date,Time Display
  190.  
  191.   A new item has been added to the main menu. By clicking on the arrows 
  192. you can shift the display left or right through File Name, Size, Date 
  193. and Time. This can also be acomplished through pressing the left/right 
  194. cursor keys.
  195.  
  196.  
  197.  
  198.  
  199.  
  200. **********************************************************************
  201.  
  202. *                   Changes for ver 2.0 12/16/89                     * 
  203. **********************************************************************
  204.  
  205.  
  206.  
  207. Media Change:
  208.  
  209.   New routines have been added to force a media change on any drive that 
  210. is altered. This should help to eliminate the problem of having to reboot 
  211. to access a newly created folder etc.. Many thanks to Don for his hours of 
  212. work in developing and testing these routines. They have been heavily 
  213. tested and seem to work fine, however if for any reason you are having 
  214. problems getting the OS to recognize any changes that have been made, 
  215. reboot IMMEDIATELY!
  216.  
  217.  
  218.  
  219. Warm Boot:
  220.  
  221.   A new item has been added in the Extras Menu that allows you to 
  222. automatically trigger a warm boot whenever you exit Cheetah.
  223.  
  224.  
  225.  
  226. Sort Options:
  227.  
  228.   Sort Options have been moved into the Extras Menu. Since there is no 
  229. longer a seperate menu for these, ^S now brings up the entire Extras Menu.
  230.  
  231.  
  232.  
  233. Load/Save Config:
  234.  
  235.   Two new buttons in the Extras Menu now allow you to save all of your 
  236. settings out to a file, or load them back in at any time. All of your 
  237. on/off settings, Auto Select parameters and Source and Destination paths 
  238. are saved. At startup the program will automatically try to load the file 
  239. CHEETAH.CNF from the same path that the program was run, if it is not 
  240. found, defaults will be used.
  241.  
  242.  
  243.  
  244. Refresh:
  245.  
  246.   Hitting ESC from the main menu will force a complete refresh of both 
  247. source and destination paths. 
  248.  
  249.  
  250.  
  251. Delete Originals:
  252.  
  253.   You are now asked for confirmation whenever you select to delete the 
  254. originals after a copy.
  255.  
  256.  
  257.  
  258. Byte Count:
  259.  
  260.   Displays the number of bytes selected in source directory. Note, this 
  261. amount does not take into account any folders that may be selected.
  262.  
  263.  
  264.  
  265. RAM Disks:
  266.  
  267.   RAM Disk compatibility has been increased. Cheetah should work fine now 
  268. with most popular RAM Disks.
  269.  
  270.  
  271.  
  272.  
  273.  
  274. **********************************************************************
  275.  
  276. *                   Changes for ver 3.0 09/28/90                     * 
  277. **********************************************************************
  278.  
  279.  
  280.  
  281.  
  282.  
  283.   BGM Compatibility: Cheetah now supports ICD's new BGM format for both 
  284.     source and destination drives. A different aglorithm had to be 
  285.     developed to support the non standard cluster sizes. This new routine 
  286.     optimizes the files as the are being copied. The new copy method can 
  287.     also be selected to be used when copying between standard partitions. 
  288.     Progress is also displayed during the copy.
  289.  
  290.  
  291.  
  292.   Main Display expanded: Main Menu now simultaneously shows filename 
  293.     and either size, date or time (saved in config). Previously you 
  294.     could scroll through filename, size, date or time, but only one 
  295.     was displayed at a time.
  296.  
  297.  
  298.  
  299.   Filename Conflict (Switchable): When the copy is initiated all 
  300.     conflicts are prompted with options to copy, skip this file or 
  301.     abort the copy. In earlier versions conflicting file names were 
  302.     just replaced without warning.
  303.  
  304.  
  305.  
  306.   "Not" mask in auto select: Two of the autoselect criteria (file and 
  307.     date masks) have been upgraded so that clicking on their titles 
  308.     toggles between selecting the files if the mask is true or false.
  309.  
  310.  
  311.  
  312.   Free space: This display has been expanded to show bytes used and free 
  313. space percentages as well as free and total. Also expanded the displays 
  314. for those really big hard drives and BGM partitions.
  315.  
  316.  
  317.  
  318.   Time Displays: All time displays have been converted to AM/PM format 
  319. instead of military format.
  320.  
  321.  
  322.  
  323.   Bug Fixes:    Found and fixed date display bug.
  324.  
  325.                 Subdirectory links now being updated properly (For
  326.                     what thats worth...).
  327.                 Free space calculations corrected (off by 2K in places).    
  328.  
  329.  
  330. Donations, Comments, Questions or Suggestions: Please write.
  331.  
  332.  
  333.  
  334. Jay Jones
  335.  
  336. PO Box 6563
  337.  
  338. Kent, WA 98031
  339.  
  340.  
  341.  
  342. or via modem at:
  343.  
  344.  
  345.  
  346. Super 68 BBS
  347.  
  348. F-Net Node 596
  349.  
  350. (206)859-9644
  351.  
  352. HST - PCP WASEA
  353.  
  354.  
  355.  
  356.